home *** CD-ROM | disk | FTP | other *** search
/ Aminet 40 / Aminet 40 (2000)(Schatztruhe)[!][Dec 2000].iso / Aminet / dev / lang / Python16.lha / Python-1.6 / README < prev    next >
Encoding:
Text File  |  2000-10-12  |  5.5 KB  |  164 lines
  1.  
  2.  
  3.                                 PYTHON 1.6
  4.                           NOTES ON THE AMIGA PORT
  5.  
  6.                              October 12, 2000.
  7.  
  8.     
  9.            Conversion and Amiga specific code by Irmen de Jong.
  10.               (Original code by Guido van Rossum and others)
  11.  
  12.  
  13.  
  14.                    Read the file <DISCL_and_COPYRIGHT>!
  15.  
  16.    It contains the disclaimer for this software, and copyright notices.
  17.  
  18.  
  19.  
  20.     Contents:
  21.     ~~~~~~~~~
  22.  
  23.     1. What's new?    
  24.     2. General remarks.
  25.     3. Troubleshooting.
  26.     4. Thanks.
  27.  
  28.  
  29. +----------------------+
  30. |                      |
  31. |  1. What's new?      |
  32. |                      |
  33. +----------------------+
  34.  
  35. Well, this is Python version 1.6 (build 1)!
  36. See the notes in Docs/NEWS for more information on what's new since 1.5.2.
  37. Be aware that there are a few language incompatibilities. Just check
  38. out the regular Python 1.6 news on www.python.org to find out what they are.
  39.  
  40. BTW Perhaps AmigaPython 2.0 will even see the light in the near future... :-)
  41.  
  42.  
  43. +----------------------+
  44. |                      |
  45. |  2. General remarks  |
  46. |                      |
  47. +----------------------+
  48.  
  49. * The MAIN PYTHON SITE is <http://www.python.org>. All general documentation
  50.   can be obtained from here (Python tutorial, language reference, library
  51.   reference and much more).
  52.  
  53. * The above mentioned documentation is also available on Aminet, as
  54.   dev/lang/Python16_Doc.lha.
  55.  
  56. * The AmigaPython homepage is at http://www.bigfoot.com/~irmen/python.html
  57.   (note the new address!). Check it out for news, future plans, bugs etc.
  58.  
  59. * In the `Docs/Amiga' directory you can find the docs for the Amiga specific
  60.   modules and features. Read them, they contain vital information!
  61.  
  62. * The Python library contains an extensive test set.
  63.   To try it yourself, type (after installation):
  64.     Python -c "import test.autotest" (and have patience...)
  65.     Python -c "import test.autotest" (and have patience...)
  66.   (Yes: do it TWICE because the generated .pyc files need to be checked too).
  67.   (You can also start the RunTest.py script from the Workbench).
  68.   Some tests cannot run on the Amiga - they will be skipped.
  69.   The report at the end should say something like:
  70.     31 tests OK.
  71.     18 tests skipped:  .....
  72.   If you don't start AmiTCP first, test_socket and test_select will fail.
  73.   If usergroup.library cannot be opened, crypt, grp and pwd will fail.
  74.  
  75. * To  see  some  command  line  options,  use  the -?  option, or any other
  76.   unrecognised option.
  77.  
  78. * To run a speed benchmark, type:
  79.     Python -c "import test.pystone; test.pystone.main()"
  80.   and have some patience. On my system, I get 355 pystones/second.
  81.  
  82. * In the `Icons' directory there are some icon suggestions.
  83.   def_py.info is an icon for Python source files (.py)
  84.   def_pyc.info is an icon for Pytnon bytecode files (.pyc)
  85.  
  86. * Mail  me  if  you encounter any Amiga specific problems, or if you have any
  87.   Amiga  related  questions  about  Python,  or  just  for fun.  General
  88.   questions are better asked on the usenet newsgroup comp.lang.python.  A lot
  89.   of   information,   including  an  online  manual,  can  be  obtained  from
  90.   <http://www.python.org/>. Read the FAQ before asking!
  91.  
  92.  
  93. +-----------------------+
  94. |                       |
  95. |  3. Troubleshooting   |
  96. |                       |
  97. +-----------------------+
  98.  
  99. * When  I  try  to  install  Python,  I  get  "Unable  to  open  your tool
  100.   'installer'"!
  101.  
  102.   The Installer® utility is required for installation, but it is not included
  103.   in  the  archive.   Get  it  from  somewhere  else  and  copy it to your C:
  104.   directory or somewhere where Workbench can find it.
  105.  
  106. * When I start python, I get "This program requires a math co-processor"!
  107.  
  108.   You should upgrade your computer to at least a 68030 with a FPU.
  109.  
  110. * I   get   "Couldn't   open   bsdsocket.library"   or   "Couldn't   open
  111.   usergroup.library" errors!
  112.  
  113.   You  are  trying to use functions that need one of these libraries.  AmiTCP
  114.   is required if you want to use all (network) functions.
  115.  
  116. * Python crashes when executing complex (recursive) code!
  117.  
  118.   This should not happen; you should get a MemoryError exception.  If it does
  119.   crash, increase your stack size and try again.  Python's default stack size
  120.   is 20K, which should be enough for most programs.
  121.  
  122. * Functions which use the PIPE: device (like os.popen) seem to work
  123.   incorrectly!
  124.  
  125.   The default l:queue-handler is buggy.  Make sure you have installed a fixed
  126.   l:queue-handler (I'm using util/sys/HWGQueue.lha from Aminet)
  127.  
  128. * Other errors
  129.  
  130.   Mail me at irmen@bigfoot.com with a clear description of the problem.
  131.  
  132.  
  133. +-----------------------+
  134. |                       |
  135. |  4. Thanks            |
  136. |                       |
  137. +-----------------------+
  138.  
  139. Ofcourse this product could never have happened without the support of various
  140. people. Amongst others I'd like to thank:
  141.  
  142. Guido van Rossum - for creating Python in the first place
  143. Mike Meyer for his various suggestions and problem reports
  144. Kent Polk for his various suggestions and problem reports
  145. Lyster E. Wick for his various contributions (NewIcons/ARexx/WB/bugreports)
  146. Marc Christiansen for his detailed description of the strftime and
  147.   amiga.crc32 problems (and persuading me to fix them)
  148. Bablos to make me start polishing up the embedded python code.
  149. Adam Chodorowski for a few new doslib functions.
  150.  
  151. And ofcourse thanks to my friends who supported me in the first phase of
  152. this project and pushed me to continue this work (that was LONG ago, in the
  153. Python 1.2 days).
  154.  
  155. If you think your name is missing here, drop me a line!
  156.  
  157. To every AmigaPython user out there: thanks for your interest!
  158.  
  159.  
  160.  
  161.  
  162.                     Irmen de Jong
  163.                     (irmen@bigfoot.com)
  164.